perm filename ERRATA.BH[S,DOC]1 blob sn#085428 filedate 1974-02-05 generic text, type T, neo UTF8



STANFORD ARTIFICIAL INTELLIGENCE LABORATORY            February, 1974
OPERATING NOTE 54.3 1/2









             M O N I T O R   C O M M A N D   M A N U A L
                        (addenda and errata)



                                 by


                            Brian Harvey










This  document  contains  corrections and  additions  to  the Monitor
Command Manual,  SAILON 54.3, reflecting  improvements in  the system
facilities  as of  the date  above. A  line printer  version  of this
document is available for network users in the file ERRATA.BH[S,DOC].







This work was supported  by the Advanced Research Projects  Agency of
the   Office   of   the   Secretary   of   Defense   under   contract
DAHC15-73-C-0435.
Monitor Command Manual (addenda and errata)                         1


------

The first  sentence of the  third paragraph on  page 4  (section 1.3)
should be replaced as follows:

A vacant terminal should say TAKE ME I'M YOURS! along with a  line of
cryptic  information  on  an  otherwise  blank  screen.   The cryptic
information is the system WHO line, described on page 17.
                   ______ ___ _____


------

The following  line should  be added to  the device  table on  page 7
(section 1.5):

  IMP      Interface Message Processor for ARPA network connections


------

Add the following  paragraph to the  description of the  audio switch
escape commands on page 21 (section 2.9):

Your program can control the audio switch selection for your terminal
by UUO.  Although programs cannot in general change the  audio switch
setting for another terminal, there  is a BEEP UUO which can  be used
to  cause any  terminal's  loudspeaker to  be connected  to  the beep
generator for a short time (less than one second).  This is  used by,
e.g., the SEND command to call the recipient's attention to a message
on his screen.  You can permit or refuse such beep connections by UUO
or by escape commands; BREAK B refuses beeps, and ESC B permits them.
Any change to your audio  switch setting by other means (e.g.  ESC U)
also cancels the effect  of BREAK B, so  you must repeat the  BREAK B
command after changing your selection.


------

Add the following paragraph to section 4.2, page 24:

If your core image includes  an upper segment (see page 11),  you can
set  or clear  the write  protection bit  with the  SETUWP  or CLRUWP
commands.  You  cannot clear  write protection  for a  sharable upper
segment if it  is protected against you.   (See the UUO Manual  for a
                                                    ___ ______
complete discussion of upper segment protection.) These commands also
take an optional octal argument, which is used to set  the protection
code for the  segment if present and  if you are permitted  to change
the code.
Monitor Command Manual (addenda and errata)                         2


------

Add the following sentence to the description of the START command on
page 25 (section 4.3):

If the octal argument is preceded  by + or -, the number is  added to
or subtracted from the program's normal starting address to determine
the desired starting address.

Also add  the following  sentence to the  description of  the REENTER
command on the same page:

An octal argument preceded by + (optional in this case) or -  will be
added to or subtracted from the reenter address.


------

Add the following sentence to the description of the FORK  command on
page 26 (section 4.4):

If the system's job capacity is used up, so that it is  impossible to
start a new job, your terminal remains attached to the existing job.


------

Add the following sentence to  the description of the command  TIME 0
on page 28 (section 4.6):

It also types the percentage spent in the monitor at interrupt level,
but this information  is provided for  the benefit of  system wizards
and is not particularly meaningful to users.
Monitor Command Manual (addenda and errata)                         3



------

Replace the first two sentences on page 31 (section 5.1,  LOGIN) with
the following:

If you log in from a remote terminal (by a dial-up telephone line) or
via the ARPA network, you may be asked for the remote users password,
                                               ______ _____ _________
which is used to discourage  unauthorized use of the system.   If the
PPN under which you wish to log in has its own password, you  are not
required to know  the remote users  password.  Also, the  PPN NET,GUE
(network guest)  is allowed  to log in  without the  password.  Users
with access to local terminals who sometimes need to log  in remotely
can set a password (with %) for their own PPNs; remote users who want
to  establish  their  own file  directories  should  communicate with
Lester Earnest.  (Log in as NET,GUE and type MAIL LES.)


------

The second line of the table of compile-type RPG commands on  page 33
(section 5.3) should be:

  LOAD     compile and load programs


------

Delete the sentence beginning " If you end the command line  with ALT
..." in  the description of  the TELNET command  on page  41 (section
5.12).  The effect formerly achieved by ALT is now used automatically
in all  cases.  Also,  add the following  paragraph after  the TELNET
description:

It  is  possible  to  establish  TELNET-like  connections  to  remote
computers by  using dial-up connections  via the  dataphones normally
used  for  incoming  dial-up lines.   Such  dataphones  are presently
associated with TTY10 and  TTY11; the dataphone on TTY11  includes an
automatic  dialing  circuit.   The  DIAL  command  will  establish an
outgoing dataphone  connection and thereafter  behave like  a TELNET.
The dial command  takes as its argument  either the device name  of a
TTY, in which case you must dial the number you want manually  on the
associated dataphone, or a telephone number in the form

{(ddd)}ddd{-}dddd

where d  represents a digit  and braces enclose  optional characters.
In the latter case,  the telephone number is dialed  automatically on
TTY11's dataphone.
Monitor Command Manual (addenda and errata)                         4


------

Add the following to section 6, page 42:

Privileges can be enabled or disabled at any time.  That is, for each
job,  the  monitor  remembers  the privileges  to  which  the  job is
entitled  as  well  as  the ones  which  are  presently  active.  All
privileges to which you are entitled are normally activated  when you
log in, but you may choose to disable any or all for  safety reasons.
The ENABLE and  DISABLE commands, with no  arguments, turn on  or off
all privileges to which you are entitled. These commands may  also be
used with a privilege name as argument, to enable or disable specific
privileges.  If you have  the PRI privilege, you can  enable specific
privileges  to which  you are  not entitled,  except  that privileges
which are  intended only  for specific  programs (XGP  font compiler,
service level monitor) cannot be enabled by any user.


------

In the description of the CETV and ETV commands on page  44 (appendix
1), in  the last line  of the  paragraph numbered 1,  the word  " of"
should  be  "  if" .  Also,  delete  the last  sentence  in  the last
paragraph on that page, numbered  3.  (TMPCOR files for each  job are
now saved separately for each alias used by that job.)


------

Insert the  following on page  66 (appendix 3,  SPOOL), before  the "
Delayed Listing" section:

File specifications may be  read from an auxiliary file  by including
in the  command line the  name of the  auxiliary file preceded  by @.
This file may include file names and switches.
Monitor Command Manual (addenda and errata)                         5



------

Add the following to the table of XSPOOL switches, page 68:

  NOXGP    Opposite of /XGP.
  NTNODE=n Sets  the  number  of  text  nodes  allocated  by the
           monitor (see below).
  NVNODE=n Sets the number of vector nodes allocated.

Also add the following at the end of page 68:

Text nodes and vector nodes are units of core storage allocation used
____ _____     ______ _____
by the monitor's XGP service routines.  Generally, you need not worry
about them, but if you  have trouble printing a complex  document the
allocation control switches  may be able to  help you.  See  a system
wizard to find out.

The  /XGP  switch,  when   present,  turns  off  the   usual  default
assumptions  about other  switches;  in particular,  /HEADING  is not
assumed unless it is explicitly used.  Spooling a file with extension
.XGP implies a default of /NONUMBER as well as /XGP.


------

In the table  of DART monitor commands  on page 78 (appendix  5), the
entries for LOCATE and TLIST should be:

  LOCATE   {<dest>←}{<source>}
  TLIST    {<dest>←}{<source>}


------

Add  the following  after the  second line  on page  88  (appendix 8,
ARPA):

The information  which follows  also applies to  the DIAL  program, a
version of T which uses dial-up telephone connections rather than the
ARPA network.  The  format of the DIAL  command is explained  on page
41.


------

On the third line of the FTP description on page 90, "  ⊗FTP←" should
be " FTP" .
Monitor Command Manual (addenda and errata)                         6


------

In the  description of the  XGP on page  97 (appendix 9),  delete the
reference to  the VERTICAL POSITION  knob.  This knob  may be  in any
position, and should not normally be changed by users.


------

Replace the last paragraph on page 101 (appendix 10,  reloading) with
the following:

If  this procedure  fails,  check that  the  NXM STOP  switch  on the
console  is turned  on; then  check the  following  switches, located
inside the second door to the left of the console: JSYS ENB and MAPAC
ENB off, MA TRP OFFSET on.

If the  system loader  tape still  fails, find  the DECtape  with the
current system.  The DECtape will be labeled with the system name and
date.  Mount it on some  DECtape drive.  Find the paper  tape labeled
256K TENDMP or  128K TENDMP, and load  it into the paper  tape reader
(on the  PDP-10).  Stop the  PDP-6.  Press RESET  and READ IN  on the
PDP-10.  The paper tape will be read, and the CTY will  type carriage
return and line feed.  Type n$  where n is the number of  the DECtape
drive and $  is an alt  mode.  The DECtape  should spin for  a while,
then it will  stop and the CTY  will type crlf again.   Type L$SYSTEM
SAV (note the space before  SAV, not a period) then  carriage return.
The DECtape  will spin  again, followed by  another crlf.   Type 206$
then G$ to start the  system.  (If the Librascope disk is  down, type
200$G$ instead.)


------

The following monitor error messages  should be added to the  list in
appendix 11, starting on page 102, in alphabetical sequence:

NO SUCH PRIVILEGE!

          The  privilege  name  specified  in  an  ENABLE  or DISABLE
          command does not exist.

NO UPPER SEGMENT!

          You typed a  SETUWP or CLRUWP  command and your  core image
          does not include an upper segment.
Monitor Command Manual (addenda and errata)                         7



NOT ONE OF YOUR JOBS.

          You typed a KILL command with a job number not belonging to
          your programmer name.

SORRY, PROTECTION FAILURE!

          You typed a SETUWP or CLRUWP command, and are not permitted
          to change the write  protection of your core  image's upper
          segment.

SORRY, YOU CAN'T HAVE THAT PRIVILEGE!

          You typed  an ENABLE command  specifying a  privilege name,
          and  neither  the  privilege  you  specified  nor  the  PRI
          privilege is in the  list associated with your PPN;  or the
          privilege is one which is not permitted to any user (XGP or
          SSL).

USE "KJOB" TO LOG YOURSELF OFF.

          You typed a  KILL command with your  own job number  as the
          argument.

Also,  add "  or KILL"  after  " ATTACH"  in the  description  of the
NO SUCH JOB message, and remove the reference to the KILL  command in
the description of the OUT OF BOUNDS message.
Monitor Command Manual (addenda and errata)                         8



------

Add the following to the monitor command summary, pages 118 and 119:

NAME      DESCRIPTION

CLruwp    clear upper segment write protect
DIAl      talk to computer by telephone
DISable   ⊂ disable privileges ⊃
ENable    ⊂ enable privileges ⊃
SETuwp    set upper segment write protect


NAME      PROGRAM   ARGUMENTS   PAGE

CLruwp              {prot}      24
DIAl      DIAL      dv | phone  41
DISable             ⊂ {priv} ⊃  42
ENable              ⊂ {priv} ⊃  42
SETuwp              {prot}      24


Also, the following should be  added to the list of  abbreviations on
page 117:

prot            octal protection code
phone           telephone number, format {(ddd)}ddd{-}dddd
priv            privilege name